Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Getting and Setting the Hit-Test Parameters

GXSetTransformHitTest

You can use the GXSetTransformHitTest function to assign new hit-test parameters to a transform object.

void GXSetTransformHitTest(gxTransform target, gxShapePart mask, 
                     Fixed tolerance);

target

A reference to the transform object whose hit-test parameters you want to assign.

mask

The shape-parts mask to assign to the target transform.

tolerance

The hit-test tolerance to assign to the target transform. It is measured in geometry units, and can be 0 or any positive number.

DESCRIPTION

The GXSetTransformHitTest function assigns the shape-parts mask contained in the mask parameter and the hit-test tolerance contained in the tolerance parameter to the transform object referenced by the target parameter. The tolerance value cannot be negative.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
transform_is_nil
parameter_out_of_range	(debugging version)
tolerance_out_of_range	(debugging version)

SEE ALSO

For information about the hit-test parameters property, see "Hit-Test Parameters" beginning on page 6-11. To interpret the values in the shape-parts mask, see Table 6-1 on page 6-12.

To retrieve the hit-test parameters of a transform object, use the GXGetTransformHitTest function, described in the previous section.

To assign hit-test parameters to the transform associated with a specified shape, use the GXSetShapeHitTest function, described on page 6-81.